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D.2 Example Assembler Shell Program for CP/M-86 Interfacing 


The Digital Research ASM-86 assembler does not follow the 
standard Intel ASM-86 structure - this makes for a more complex 
task when transferring assembler programs between the CP/M-86 and 
the MS-DOS operating systems. The operating system interfacing 
technique is via a straightforward interrupt (INT E@Hex), with 
the required operational parameter in the CL register. CP/M-86 
corrupts all registers, excepting the CS and IP - it is, 
therefore, recommended that all registers be pushed prior to the 
INT E@Hex being issued. An example of the running and exiting 
program technique, plus the required assembly directives, 
follows. The program example follows that of the MS-DOS MACRO-86 
example. At GENCMD time, this programming example will generate a 
-CMD file - the header information on this file type is shown in 
the System Guide for CP/M-86. 


title "Example of CP/M-86/ASM-86 Programming' 

reset equ GOSGGh ;system reset function 

cpm equ G9GeGh ;interrupt to operating system 
cseg 

begin: 
call run_module ;xrun the program 


run ends - select close down 


=e =6 WO 


mov cl,reset ;select system reset 
mov d1,@@h ,;select memory recovery 
int cpm yreturn to operating system 


g 
run_module: 
;##### insert your code at this point ###### 
ret sreturn to exit module 


dseg 


s###4## Insert your data here ##### 
end 
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MS-DOS -- EXE File Header Structure 


The Microsoft linker outputs .EXE files in a relocatable 
format, suitable for quick loading into memory and 
relocation. EXE files consist of the following parts: 


o Fixed length header 
o Relocation table 
Oo Memory image of resident program 


A run file is loaded in the following manner: 


o Read into RAM at any paragraph (16 byte) boundary 
o Relocation is then applied to all words described by 
the relocation table. 


The resulting relocated program is then executable. 
Typically, programs using the PL/M small memory model have 
little or no relocation; programs using larger memory models 
have relocation for long calls, jumps, static long pointers, 
= of 


The following is:'a detailed description of the format of an 
EXE file: 
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Byte 
O+1 
2+3 


4+5 


6+7 
8+9 


A+B 


C+D 


E+F 

10+11 
12+13 
14+15 
16+17 
18+19 


LA+1B 


a 
@ 
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Microsoft .EXE File Main Header 


Name Function 
wSignature Must contain 4D5Ahex. 
cbLastp Number of bytes in the memory image 


modulo 512. If this is @ then the last 
page is full, else it is the number of 
bytes in the last page. This is useful 
in reading overlays. 

cpnRes Number of 512 byte pages of 
memory needed to load the resident and 
the end of the EXE file header. 


irleMax Number of relocation entries in the 
table. 

cparDirectory Number of paragraphs in EXE file 
header. 

cparMinAlloc Minimum number of 16-byte paragraphs 
required above the end of the loaded 
program. 

cparMaxAlloc Maximum number of 16-byte paragraphs 


required above the end of the loaded 
program. OFFFFh means that the program 
is located as low as possible into 


memory. 

saStack Initial value to be loaded into SS 
before starting program execution. 

raStackInit Initial value to be loaded into SP 
before starting program execution. 

wchksum Negative of the sum of all the words 
in the run file. 

raStart Initial value to be loaded into IP 
before starting program execution. 

saStart Initial value to be loaded into CS 
before starting program execution. 

rbrgrle Relative byte offset from beginning of 
run file to the relocation table. 

10Vv Number of the overlay as generated by 


LINK-86. The resident part of a 
program will have iov = @. 


The relocation table follows the fixed portion of the run 
file header and contains irleMax entries of type rleType, 
defined by: 


rleType bytes @+l ra 
bytes 2+3 sa 


Taken together, the ra and sa fields are an 8086/8988 long 
pointer to a word in the EXE file to which the relocation 
factor is to be added. The relocation factor is expressed as 
the physical address of the first byte of the resident 
divided by 16. Note that the sa portion of an rle must first 
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be relocated by the relocation factor before it in turn 
points to the actual word requiring relocation. For 
overlays, the rle is a long pointer from the beginning of 
the resident into the overlay area. 


The resident begins at the first 512 byte boundary following 
the end of the relocation table. 


The layout of the EXE file is: 


28-byte Header 
Relocation Table 
padding (<2@@hex bytes) 


memory image 
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F.l Victor 9999 Technical Specification 


Processor | 
o Intel 8088 16-bit microprocessor 
o 128k bytes RAM internally upgradeable to 896k bytes 
o 4k bytes Auto-boot ROM (read only memory) 
o 4 internal expansion slots for plug-in card options 
Oo 2 x RS232C serial communications ports 
o 1x Parallel (Centronics) or IEEE-488 port 
Oo 2 x Parallel user port (5@-way KK Connector on CPU board) 


Display System 
o 25 line x 8@ column screen / 59 line x 132 column screen 
o 12" CRT, Green p39 phosphor 
o Adjustable horizontal viewing angle (+ 45 degree swivel) 
o Adjustable vertical viewing angle (@ deg to 11 deg tilt) 


Floppy Drives 

o Standard 5 1/4-inch, single-sided 96 TPI dual disk drives, 
with a maximum capacity of 600k bytes per drive. 

Oo Optional 5 1/4-inch, double-sided 96 TPI dual disk drives, 
with a maximum capacity of 12@@k bytes per drive. 

o Optional single 198,0990k byte Hard Disk - non-removable; with 
Single 5 1/4-inch, double sided 96 TPI disk drive with a 
maximum capacity of 120@0k bytes. 


Single-sided floppy drive offers 8@ tracks at 96 TPI 
Double-sided floppy drive offers 16@ tracks at 96 TPI 

Floppy drives have 512 byte sectors; utilising a GCR, 19-bit 
recording technique. 


Floppy access times: 
2 micro-second per bit data transfer rate, with an 
interleave factor of 3. Average seek time 1s 
approximately 98 milli-seconds. 


Hard Disk access times: 
8.2 micro-second per bit data transfer rate, with an 
interleave factor of 5. Average seek time is 
approximately 190 milli-seconds. 
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Keyboard 


Separate Intel 80848 microprocessor ais 
Fully software definable with 1@ soft function keys 

Full IBM Selectric III (56 key) keyboard layout 

Type ahead buffering to 32 levels and full n-key rollover 

Keyswitches rated for 108 million operations 


Electrical 


Input voltage 98-137 VAC or 198-278 VAC (internal jumper) 
Input frequency 47-63 Hz 


Environment 


Operating temperature @ deg C to 40 deg C 
Operating humidity 280% to 88% (non-condensing) 
Storage temperature -28@ deg C to 7@ deg C 
Storage humidity 5% to 95% (non-condensing) 
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F.2 Victor 9999 Physical Specifications 


Mainframe Assembly 


Height 
178 mm 
7 in 


Display Assembly 
Height 


264 mm 
19.4 in 


Keyboard Assembly 


Height 
45 mm 
1.8 in 


System Assembly 
Height 


457 mm 
18 in 


Width 
422 mm 
16.6 in 


Width 
326 mm 
12.9 in 


Width 
483 mm 
19 in 


Width 
483 mm 
19 in 


Depth 
356 mm 
14 in 


Depth 
339 mm 
13.4 in 


Depth 
203 mm 
6.4 in 


Depth 
559 mm 
20.4 in 


Weight (approx) 
12.6 kg 
281 lbs 


Weight (approx) 
8.1 kg 
18 lbs 


Weight (approx) 
1.5 kg 
3 lbs 


Weight (approx) 
22.2 kg 
49 lbs 


Width without the keyboard module is 396 mm / 15.6 in 
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G.l Glossary of Terms» 


The following table is a glossary of terms found in this manual: 


BAUD The term baud rate means the number of bits 
sent down a line per second. A baud rate of 
39@ will, therefore, be capable of 
transmitting data at 3098 bits per second. 
Since a textual character is composed of 8 
bits, then 37.5 characters could be sent per 
second at this baud rate. 


BIOS This means the Basic Input Output System. The 
BIOS is a fundamental portion of an Operating 
System, allowing the operating system to 
communicate correctly with any peripheral 
devices; typical BIOS modules include the 
disk driver; the keyboard input driver; the 
screen driver; the printer driver. 


BIT A bit is a binary digit. The bit can, 
therefore, contain either One or Zero. A One 
is bit HIGH or ON. A zero is bit LOW or OFF. 
A bit may be likened to a light-switch - the 
Switch can only be on or off. See BYTE. 


Naw BOOT This term comes from the phrase "the computer 
pulls itself up by its boot-strap". The term 
boot-strap means the same, but is no longer 
in such common use. To boot a computer is to 
load an operating system - the computer does 
this by means of a boot-strap program. The 
computer, when switched on, is not aware of 
its environment - but it automatically runs 
its boot-strap program. The Victor 9899 boot- 
strap program is stored in the boot PROM; it 
first causes the display of the little disk 
picture - it then searches for a disk with an 
operating system - when it finds this disk, 
it loads the operating system and begins to 
execute it. The boot-strap program is not 
used again until the reset switch is pressed, 
or the power is switched off and on. 


BUS A bus in computer jargon is not unlike a bus 
to carry passengers. When data is moved 
around inside a comptiter it is moved along 
the bus wires. These bus wires connect the 
Victor 9888 microprocessor to its memory, 
disk(s) and screen. 
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BYTE 


DOT MATRIX 


FONT CELL 


HEADER 


INTERRUPT 


NIBBLE 


OPERATING 
SYSTEM 


A byte is a collection of 8-bits or two 
nibbles. A byte may store one character of 
text, or a number from @ to 255 in binary. 


A printed character on the screen or a dot- 
Matrix printer may be viewed as a square 
containing dots. On the Victor 9898 screen a 
character haS a square cell (matrix) of 16 
dots high by 1@ dots wide - within this box, 
the dot on/off patterns create a viewable 
character. 


In reference to DOT MATRIX, the font cell is 
the collection of bytes of data that make up 
the character dots that are to be displayed 
on the screen. Each character on the screen 
is composed of pre-defined patterns of dots 
to make the viewed dot matrix. These patterns 
of dots are stored in the Victor 9889 memory 
as data - the screen controller chip scans 
these data bytes and the resulting character 
image is displayed on the screen. 


A header ona file gives information to the 
operating system on where and how the file is 
to be loaded in to memory. Many files 
provided by Victor Technologies (such as 
keyboard and character set files) contain 
headers that are not used by the operating 
system, but are used by Victor Technologies 
utilities. 


An interrupt is some event occuring in the 
computers environment that the computer will 
stop all other activities for. An example of 
an interrupt is a key-press. If you press a 
key on the Victor 9809, an interrupt is 
generated; at this point the processor stores 
all information on its current task and gets 
and saves the value of the key pressed; it 
then picks up all the information it stored 
on its last task and continues where it left 
off. This whole series of events takes onlya 
few micro-seconds. 


Sometimes spelled NYBBLE; a nibble is half a 
byte or 4-bits. See BYTE and BIT. 


An operating system allows the computer to be 
aware of its environment and gives the user 
the ability to enter and retrieve data from 
the computer. 
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PROM 


RAM 


REGISTER 


WORD 


Programmable Read Only Memory, PROM, is a 
chip or collection of chips that is used to 
store permanently a single computer program 
or collection of computer programs. The boot- 
prom, sometimes called boot-rom, contains all 
the information the Victor 998089 computer 
needs to read an operating system from disk. 
There are different types of prom; EPROM 
which is erasable prom, simply shine a high- 
powered ultra-violet lamp on the chip, and it 
can be re-programmed; etc. 


Random Access Memory, RAM, is a chip or 
collection of chips that is used to store 
temporarily (until the power is removed) 
data, computer program(s), text, etc. This is 
the memory of a computer. 


A computer register is a portion of the 
processor. The Victor 9898 uses the Intel 
8888 micro-processor - there are several 
different types of registers within this 
chip; there are 8-bit registers, and 16-bit 
registers. Data is generally not manipulated 
in RAM, but is brought in to a register of 
the processor and manipulated there, then the 
result saved from the register back into RAM. 


A word is a number of bits, generally greater 
than 8. The Victor 98909 has a 16-bit word - 
thus a word in the Victor 9809 is composed of 
two bytes. The DEC PDP-8 computer has a l2- 
bit word - on this machine, therefore, a word 
is composed of one byte and one nibble. 
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H.1 MS-DOS Base Page Structure 


The MS-DOS Base Page (sometimes called the Program Segment Prefix 
or PSP), is created when you enter an external command. 
COMMAND.COM will allocate a memory region to the external 
program, and will insert the Base Page prior to the origin of 
this program. 


In the memory segment that the program is to load, COMMAND.COM 
places a Base Page, COMMAND.COM then loads the program at an 
offset of 1@0@hex, and hands over control to the external program. 
The external program, once its function is complete, hands 
control back to the operating system by a far JUMP or far RETURN 
to location zero within the Base Page; the instruction at this 
location is an INT 20, or return control to MS-DOS. This stage 
must be executed to allow MS-DOS to recover memory correctly (see 
Appendix D.1). 


When an external program is loaded, the following conditions are 
trues 


The file control blocks at Base Page locations 5Chex and 
6Chex are created from the first two parameters entered on 
the command line. 


The command line at Base Page location 8@hex is created from 
the command line entered AFTER the program filename. The 
byte at location 8@hex contains the command line character 
count, the following bytes contain the raw command line as 
entered at the keyboard. 


The word at offset 6 in the Base Page contains the number of 
bytes available in the segment. 


The contents of register AX are established to reflect the 
validity of the drive(s) on the command line. Thus the 
following may be found: 3 


AL = FFhex when the first drive letter on the command 


line was not recognized by MS-DOS. 
AH = FFhex when the second drive letter on the command 


line was not recognized by MS-DOS. 


The above applies equally to both .EXE and .COM type files. The 
e-EXE and .COM files do have differences when the they load, and 
these are described more fully below. 


H-1 Rev @ - 4/26/83 


When 


When 


Supplemental Technical Reference Material 


-EXE files load: 


The contents of register DS and register ES are pointing at 
the Base Page segment address. 


The registers CS, IP, SS and SP are initialized to those 
values passed by the linker. , 


-COM files load: 


The contents of registers CS, DS, ES, and SS are pointing to 
the Base Page segment address. 


The register IP is set at 1@@hex. 

The register SP is set the high address in the program 
segment, or to the base of the transient portion of 
COMMAND.COM, whichever is the lower. The contents of the 


word at Base Page offset 6 are decremented by 1@@hex to 
allow for a stack of that size. 


A word of zeros is placed at the top of the stack. 
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es The Base Page 


The Base Page is structured as follows - with offsets in Hex 


Offset Contents 
CBSO INT 2@hex. Word. 
GOG2 Total Memory size in paragraph form (i.e. 


209@hex 1s equivalent to 256k bytes). Word. 


GOO5 Far CALL to MS-DOS function dispatcher. 5 
bytes. 
GOGA Program Terminate address as IP and CS. 2 
words. 
OOGE Control Break address as CS and IP. 2 words. 
G85C File Control Block #1, formatted as normal 
unopened FCB. 8 words. 
GB6C File Control Block #2, formatted as normal 
unopened FCB. 8 words. 
GG8G Count of characters on command line; followed 
| by command line entered. This region may be 
ad used as disk transfer address. 
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Normal File Control Block 


The normal file control block is structured as follows - with 


offsets in decimal: 


Byte 
i) 


14-15 


16-19 


Contents 
The drive number. The drives are numbered as 
follows: 


Before opening file: @=default drive 
l=drive A 
2=drive B 
3=drive C, etc 


After opening file: l=drive A 
2=drive B, etc 


MS-DOS replaces the default drive prefix of @ 
with the correct drive number after the open 
1s processed. 


Filename, left justified with trailing ASCII 
space(s). If a device name is placed in this 
region, the trailing colon should be omitted. 


Extent, left justified with trailing ASCII 
space(s). 


Current block number relative to the 
beginning of the file, starting with zero 
(automatically set to zero by the open 
function request). A block consists of 128 
records, each record being of the size 
specified in the logical record size field. 
The current block number is used with the 
current record field for sequential 
reads/writes. 


Logical record size in bytes. Set to 8@hex by 
the open function request. 


File size in bytes. The first word represents 
the low-order part of the file size. 
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28-21 Date the file was created or last updated. 


The date is set by the open function request. 
The date is formatted as follows: 


< 21 > << 20 > 
15 141312411410 9 8 7 6 5 4 3 2 1 @g 
y yy yy Y yy Y mm@omom@@mdadaedaddadda@4ad 


where m month l1thrul2 
d day lthru3l 
y year G@thrull9 (1980thru2999) 


22-23 Time the file was created or last updated. 


The time is set by the open function request. 
The time is formatted as follows: 


< 23 > << 22 > 

15 14131211410 9 8 7 6 5 4 3 2 1 @ 

h h h h h om mmmi#mieméées ss s §s§ § 
where h hours Gthru23 


m minutes Gthru59 
S seconds*2 @thru59 


24-31 Reserved for system use. 


Current relative record number (@-127) within 
the current block. This must be set before 
doing segeuntial read/write operations on the 
file. The open function request does not set 
this field. 


33-36 Relative record number, relative to the 


Origin of the file, starting at zero. This 
field must be set prior to doing random 
read/write operations on the file. The open 
function request does not set this field. 


If the record size is less than 64 bytes, 
both words are used. If the record size is 
greater than 64 bytes, then only the first 
three bytes are used. 


The File Control Block at 5Chex in the Base Page overlaps 
both the File Control Block at 6Chex and the first byte 
of the command line area/disk transfer area at 8@hex. 


Bytes @thrul5 and 32thru36 must be set by the user 
program. Bytes l6thru3l are set by MS-DOS and may only be 
changed at the programmers own risk. : 


In the 8@86/8@88 all word fields are stored least 
Significant byte first - this is true in setting the 
record length, etc. 


H-5 Rev @ - 4/26/83 


Supplemental Technical Reference Material 


Extended File Control Block 


The extended FCB is used to create or search for files having 
special attributes. The extended FCB adds an additional 7 bytes 
preceeding the normal FCB. The extended FCB is structured as 
follows: 


Byte Contents 7 
FCB-7 Set to FFhex indicates that an extended FCB 
is being used. 


FCB-6 to FCB-2 are reserved. 


FCB-1 Attribute byte to include hidden files 
(@2hex) or system files (@4hex) in directory 
searches. 


FCB-@ Origin of normal FCB (drive byte). 
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APPENDIX I 


I.l Interrupt Driven Serial Input/Output 


This appendix is designed to show the methodology involved in 
driving the Victor 98900 in interrupt mode when communicating via 
the serial port(s). Some pitfalls are described, and tested 
sample routines are included. There are, currently, no system 
level facilities that enable this task to be accomplished easily, 
and some chips, namely the PIC 8259, PIT 8253, SIO 7281 and the 
VIA 6522 will require re-programming. It 1s up to the programmer 
to reset the machine to the original state prior to exiting the 
interrupt driven application. 


A typical interrupt driven application will normally follow the 
steps outlined below: 


1) Save the original vector, set the new vector. 

2) Set the direction bits. 

3) Enable clocks (internal or external). 

4) Reset SIO 7201 device, define your communication 
characteristics. 

5) Set the baud rate. 

6) Set the PIC 8259 to enable SIO interrupts. 


These steps will be discussed in more detail throughout the text. 
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I.2 Interrupt Vectors 


There are 256 software interrupts available to the Victor 9909. 
Most are reserved for system functions, and diagnostics. A block 
of vectors from 8@Hex thru BFHex are set aside for applications. 


“ee ok Vectors available on the Victor 9999 
98 - 1FHex Intel reserved. 
20 - 3FHex Microsoft reserved. 
40 - 7FHex Victor reserved. 
88 - BFHex Applications reserved. 
CQ - FFHex Victor reserved. 


Vectors 4@Hex thru 47Hex are those belonging to devices 
controlled by the Programmable Interrupt Controller (PIC). 


4@Hex Sync IRQ 
41Hex SIO 7201 
42Hex Timer 8253 
43Hex General Interrupt Handler (all 6522 IRQ's) 
44Hex IRQ4 
45Hex IRQ5 
46Hex Keyboard - keystroke 
47Hex 8887 math processor 
1.2.2 Location of Vectors 


Vectors consist of a long pointer (double word) to an interrupt 
service routine. This pointer is a 4 byte entry consisting of the 
Segment and Offset of the Interrupt Service Routine. The vectors 
are stored ina table that has its origin at @900:0000. The first 
entry in this table is, therefore, Interrupt @; the vector for 
Interrupt 1 is the second, with its vector having an origin of 
G@G00:0004. The interrupt vector for Interrupt 4lHex (the SIO 
7201) will be found at location 90900:01904 (4*4lHex). 


To set a vector into this table, the MS-DOS function 25Hex can be 
used, but since it 1s desirable to restore the old vector prior 
to the application program exiting, it is less cumbersome to 
simply set the new vector "by hand", and restore the old vector 
when the application terminates. 
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I.2.3 Set Vector - Assembler Example 


»store old vector, and set new vector for SIO 


cli ;clear interrupts 

XOrKr ax,ax * AX = @00@0 

mov ES,ax saccess table via ES 
mov ax,word ptr ES: [104h] ;get old offset 

mov word ptr old offset,ax save old offset in DS 
mov ax,word ptr ES: [196h] ;0ld segment 

mov word ptr old segment,ax ,;save old segment 

mov ax,my sio_isr ,get offset to my code 
mov word ptr ES: [(1@04h] ,ax sset vector offset 

mov word ptr ES: ([(1@6h],CS ; and the new segment 
sti s;enable interrupts 

ret sall done, exit 


sto replace the old vector prior to exit 


cli sclear interrupts 
XxOYr ax,ax * AX = @800O 

mov ES,ax saccess table via ES 
mov ax,word ptr old offset sget old offset 

mov word ptr ES: [104h] ,ax srestore old offset 
mov ax,word ptr old segment ;get old segment 

mov word ptr ES: [196h] ,ax ;restore old segment 
sti ;enable interrupts 
ret sall done, exit 
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I.3 Enabling Internal and External Clocks 


In an asynchronous environment the transmit clock is generated 
internally, as opposed to a synchronous environment where the 
transmit clock is typically provided by an external source. 


Internal clocking is selected by masking off the appropriate bit 
in register 1 of the keyboard Versatile Interface Adaptor (VIA). 


The keyboard VIA, resgister 1, is located at E804:90@1. 
The appropriate bits are: 


Bit @ (PA@) for port A 
Bit 1 (PA1) for port B 


Thus, by setting PA@ to zero, the internal clock is enabled for 
port A; setting PAl to zero will enable the internal clock for 
port B. Setting PA@ or PAl to one will enable the external clock, 
disabling the internal clock. CAUTION: Care must be taken to 
leave the other bits in the pre-selected state. 


To enable internal clocks for ports A and B mask off the two 
least significant bits in register 1: 


mov ax,@e8@4h ;keyboard VIA segment 
mov ES,ax ;select the segment register 
and byte ptr ES:[8@001],@fch ;A & B internal clocks done 


To enable external clocks on either channel then set the relevent 
bit by OR'ing the bit in. The following sample sets the external 
clocks for both ports A and B: 


mov ax,@e804h ;keyboard VIA segment 
mov ES,ax ;select the segment register 
or byte ptr ES: [808001],@93h 7A & B external clocks done 


I.3.1 Providing Clocks 


In a synchronous environment it sometimes becomes necessary to 
provide transmit and receive clocks from the Victor 9909. This 
requires that the cable used has pins 15, 17 and 24 jumpered at 
the Victor 9998 end. The Victor 9990 always has a clock on pin 
24, this being provided by the internal baud rate generator; thus 
by Jumpering pin 24 to both pins 15 and 17, this clock becomes 
available for both the transmitter and the receiver, at both ends 
of the cable. ) 


When providing clocks from the Victor 9800, the external clock 
must be set as well as a baud rate selected. In synchronous mode, 
the "divide by rate" of the PIT 8253 is 1, therefore the values 
used to set the required baud rate is 1/16 the values used in an 
asynchronous environment. (See section 3.8.2 for values). 
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I.4 Initializing the SIO 


There is little magic used in this step, but it is recommended 
that the programmer read the entire Intel/NEC 7201 chip data 
sheet. The SIO segment is found in segment location E@@4Hex. The 
offsets for the data ports A and B and control ports A and B are 
at 0, 1, 2, 3 respectively. 


The following example of initializing the SIO 7201 is for Port A: 


cli disable interrupts 
mov ax,@e9@04h z;the SIO segment 
mov ES,ax ; uSing ES 


mov byte ptr ES: [(@@02h],18h ;channel reset 
; now delay at least 4 system clock cycles 


nop 
nop ;delay for 7261 


mov byte ptr ES: [@@@2h],12h ;reset external/status 
; interrupts 


;and select register 2 
mov byte ptr ES: [@@92h],14h ;non-vectored 
mov byte ptr ES: [@@0@83h],82h ;select CR2 B 
mov byte ptr ES: [9@003h],@0@h ;set vector to 9g 


set for clock rate of 16*; 1 stop bit; parity disabled 


=e 


mov byte ptr ES: [@002h],@04h ;select CR4 A 
mov byte ptr ES: [@@@2h],44h ; 


this register defines the operation of the receiver: 
7 data bits; auto enable and receive enable 


m™e 68 


mov byte ptr ES: [99@@2h],0@3h ;select CR3 A 
mov byte ptr ES: [@@@2h],6lh ; 


CR5 controls the operation of the transmitter 
7 data bits, dtr; assumes half-duplex 


me se 


mov byte ptr ES: [@@02h]),@05h ;select CR5 A 
mov byte ptr ES: (@902h],@aQGh ; 


set status: affects the vector, interrupt on every character, 
enable transmitter interrupt 


=e ‘WO 


mov byte ptr ES: [@@82h],@lh select CRI A 


7 
mov byte ptr ES: [@@82h],17h_ =; 


sti ; enable interrupts 
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I.4.1 Baud Rate for SIO 


At this point, baud rate must be selected. In an asynchronous 
environment the PIT 8253 divides the supplied baud rate by 16; 
but in a synchronous environment the baud rate is divided by l. 
Thus, to set the baud rate in an asynchronous environment, the 
value written to the PIT 8253 is 16 times the desired baud rate 
value. The common baud rate values, and the method of 
establishing the baud rates, are shown in Section 3.8.2 of this 
manual. 


I.4.2 Set the PIC to Enable SIO Interrupts 


In the Victor 9800 the PIC is normally initialized to operate the 
SIO in a polled environment. The following lines of code sets the 
PIC to operate the SIO in an interrupt environment: 


The PIC resides at segment E@@@Hex and the register required here 
is at offset #001: : 


cli ;disable interrupts 
mov ax,8e@@Gh ,;get the PIC segment 
mov ES,ax ; 


g 
and byte ptr ES: [(@0@01h],(not 92h) ;mask off bit 1 


sti sallow interrupts 


Prior to exiting the interrupt drievn application, the PIC should 
be returned to operating the SIO in polled mode. This is done by 
setting bit 1: 


cli ;disable interrupts 
mov ax,G@eGGGh ,get the PIC segment 
mov ES,ax ; 

or byte ptr ES: [@0@01lh],92h ;set polled 

sti sallow interrupts 
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When an interrupt occurs in non-vectored mode, SIO register CR2 B 
contains the vector number of the interrupting device. Assuming 
the SIO was initialized as earlier described in this appendix, 
CR2 B contains a value in the range @-7, which serves as the 
index to the following interrupt vector table: 
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;tx int for port B 
external status changed 
;recv int port B 

yrecv error port B 

s;tx in for port A 
7external status changed 


grecv in port A 


,recv error port A 


;save stack seg 
, and stack pointer 
sinternal stack 

; defined in DS (dgroup) 


s;save environment 


s;set to internal data 
;set SIO segment 


g 

,select CR2 B 
sread int device 
sword align 

> hi = @ 

,get vector table 
;point to entry 
s;service routine 
;keep disabled 


1.5.1 Sample Interrupt Service Routine 
data segment public ‘data' 
int vectors dw tx_int_b 
dw ext status b 
dw recv_int_b 
dw recv err b 
dw tx _int_a- 
dw ext_status a 
dw recv int a 
dw recv err a 
data ends DS 
code segment public ‘code’ 
assume CS:cgroup, DS:dgroup 
sio isr: 
mov word ptr CS:current_ss,S& 
mov word ptr CS:current_sp,SP 
mov SS,word ptr CS:ss origin 
mov SP,offset dgroup:stack top 
push ax 
push bx 
push cx 
push dx 
push bp 
push DS 
push ES 
mov DS,dgroup 
mov ax,@e004h 
mov ES,ax 
mov byte ptr ES: [@9903h],92h 
mov al,ES: [@093h] 
add al,al 
mov ah,@ 
mov bx,offset int vectors 
add bx,ax 7 
call [bx] 
cli 


--See next page for continuation-- 
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I.5.1 continued 


> now an "end of interrupt" (EOI) must be issued to the 
>; SIO (port A) and to the PIC. 


mov ax,@e@@Gh ;PIC segment 

mov DS,ax ; 

mov byte ptr [9@42h],38h EOI to ctrl A of SIO 
mov byte ptr [@999h],6lh *EOI to PIC ctrl port A 
pop ES srestore environment 
pop Ds 

pop bp 

pop dx 

pop cx 

pop bx 

pop ax 

mov SS,word ptr CS:current_ss ;get SS 

mov SP,word ptr CS:current sp ;get SP 

iret sinterupt return 


> the SS origin is stored here during initialization 


ss origin dw ) *stack segment origin 
current _sp dw g ;SP on ISR entry 
current_ss dw g 75S on ISR entry 


NOTE: Some variables are stored within the code segment, as the 
CS register is the only register containing a known value at the 
time of interrupt. 
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I.6 Setting Direction Bits 


This function need only be performed once, and is performed by 
the operating system BIOS following a hardware reset. This step 
need not be implemented, therefore, if a standard Victor or 
Sirius operating system is used. If a standard operating system 
is not used, then this step needs to be performed immediately 
prior to the enable clock code. 


*The offset to the data direction register is @99@03Hex. 


cli sdisable interrupts 
mov ax,@e8@4h ;kbd VIA segment 
mov ES,ax ; 

mov al,byte ptr ES: [99@3h] get the old value 
or al,@3h ;set for output 


set the PA2-5 to zero, to enable DSR and RI input 


me SOG MO 


and al,9@c3h smask in 
mov byte ptr ES: [@@@03h],al ;rewrite new value 
sti senable interrupts 
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APPENDIX J 


Jel Character Set Header 


All files with the extension .CHR are Character Set table files. 
These files contain data corresponding to the actual dot matrix 
displayed for each character on the console. These files also 
contain information regarding the character set name, version 
number, origin, date of creation, and display class. The 
Character Set table file header is a 128 byte field, structured 
as follows: 


Byte No. Function 

Hex Dec 

GG GG Character Set type, ASCII ‘'C' = character 

G1 G1 Character Set Version Number (ASCII 98 thru 9) 

G2-@8D 92-13 Display Class 

G@E-15 14-21 Character Set Name 

16 22 Filler (ASCII Space) 

17-19 23-25 Banner Class 

1A 26 Filler (ASCII Space) 

1B-3D 27-61 Comment 

3E-4D 62-77 Originator 

4E-55 78-85 Creation Date - arranged as YY/MM/DD 

56-59 86-89 Number of records in the file in ASCII. 
A character set file of 128 characters has 32 
records; a character set file of 256 
characters has 64 records. The record count 
for a 32 record file is stored as 39 39 33 32 
(89832). 

5A-5B 99-91 Reserved. 


Over.. e 
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Byte No. Function 
Hex Dec 
5C 92 This byte is used to house three variables. 


Bit 7 is used to show the Horizontal/Vertical 
alignment of the character set - bit 7 ON 
infers a Vertical character set. Bits 6 thru 
4 of the high nibble is used to store the 
binary Super/Subscript value (which may be 1 
thru 7) offset from 1 - thus a Super/Subsript 
value of two would be stored as binary 2. 

The low nibble is used to store the binary 
Character Height offset from @ - thus a 
Character Height value of 16 would be stored 
as binary F. The Character height is a 
function of the number of vertical pixels the 
character will occupy in the 16x1@ pixel 
matrix available for each character on the 
screen. 

If the Horizontal/Vertical bit, the 
Super/Subscript value and the Character 
Height value was as stated above, then this 
byte would read AF. The byte appears: 


Bit [7] [65 4 ] [3 216 ] 
Function Horiz/Vert Super/Sub Character Height 
5D 93 This byte contains two values; the 


User/System character set toggle, bit @ 
stores this value; and the Stock/Special 
character set toggle, bit 1 stores this 
value. Bit @ ON infers that the character set 
is a system character set. Bit 1 ON infers 
that the character set is a special character 
set. 


5E 94 This byte contains information on the 
character set width. If the high nibble is @, 
then the low nibble contains the binary 
information, offset from 8, of all the 
characters in the character set - thus a 
character set width value of 16 would be 
stored as F. If the high nibble is F, then 
the character set iS a proportional one - the 
proportional character set has a trailing 
record containing information on the width of 
each individual character in the character 
set. A proportional character set is designed 
to be used in high-resolution mode as it 
requires a 16x16 screen cell. 


5F-7F 95-127 Reserved. 


89- 128- The character set font information. 
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E8/FT/9 - O ABU Sage 


26 08 968 9B 08 OB OB OH 98 06 OB OB BH BH BH HO OL 
06 98 OB OH OD OH BH BO 02 0D O08 OD O98 BH BH HO = 69 
06 di OO dL OO OOH HE CE GE OF 9E TE de Le Ht dc °OS 
ce BE OZ OC EL AI G9 HL €L 6L tS Of tL SL 69 CL OD 
69 €S B82 O02 BC B2 VL SI €L O92 CL G9 FL £9 TOI CL “OE 
T9 89 €9 82 O09 T9 AD AY 69 VL CL 49 OL dO CL BL =O 
Ol a9 69 89 FS HC CS BF Cv O02 OC OC OC OC OS Av “OT 
CS OS OC OC OC BOC HC BC 02 O09 Lc PL AD 6F HE EP 78 
XOH UT ONTEA 29SFFO XOH 


s3eS AaZoOeAeyD TeuotyzAodoad e st pue ‘szaqZoeAeYO 
8ZIT SUuTeIUOD dOYd “YHO*dOUd FOES ASZOeAeYO |YyR AOF ASTTF 
STqeL 7eS AeRZoOeAeYD Sy WOAF uUaYZe ASpeay Tenjzoe ue ST HUTMOTTOG 


Jape9H STta STqeL OS AaQ_oeAeYD aeTduwes 
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J.2 Proportional Character Set Trailer Information 

In the case of a proportional character set, the trailing 128 
bytes of the character set file contains information on the 
proportional width of each of the characters in the file. A 
proportional character set may not, therefore, contain more than 
256 characters. 

The following is a sample taken from the character set PROP.CHR; 
the hex figures represent the width for each proportional 
character starting with the space character. Note that each width 
value is offset from @, with a value range of 1 thru 16 decimal. 
Each byte is stored, and represented below, in low/high order; 
the two nibbles would be exchanged to give the value to the 
character(s) in high/low order. Each character is mapped from the 
proportional width as follows: 


29 95 98 49 77 88 84 93 


The above figures are for the first 16 display characters 
including the space character - they correspond as follows: 


space = 18 (corresponding to 9) 
! = 3 (corresponding to 2) 
" = 6 (corresponding to 5) 
# = 19 (corresponding to 9) 
S = 9 (corresponding to 8) 
% = 18 (corresponding to 9) 
& = 10 (corresponding to 9) 
' = 5 (corresponding to 4) 
( = 8 (corresponding to 7) 
) = 8 (corresponding to 7) 
* = 9 (corresponding to 8) 
etc 
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Keyboard Table Header 


All files with the extension .KB are Keyboard Table file. These 
files contain information regarding keyboard code generated when 
a key on the keyboard is pressed. These files also contain 
information regarding the Keyboard Table name, version number, 
Origin, date of creation, and display class. The Keyboard Table 
table file header is a 128 byte field, structured as follows: 


Byte No. 


Hex 


8G 


G1 


G2-G8D 


9E-15 


16 


17-19 


1A 


1B=-3D 


3E-4D 


4E-55 


56-59 


5A-7F 


80 - 


Dec 
OG 
91 


82-13 


14-21 


22 
23-25 
26 
27-61 
62-77 
78-85 


86-89 


98-127 


128- 


Function 


Keyboard table type, ASCII 'K' = character 
Keyboard table Version Number (ASCII @-9) 
Display Class 

Keyboard Table Name 

Filler (ASCII Space) 

Banner Class 

Filler (ASCII Space) 

Comment 

Originator 

Creation Date - arranged as YY/MM/DD 

Number of records in the file in ASCII. 

A character set file of 128 characters has 32 
records; a character set file of 256 
characters has 64 records. The record count 
for a 32 record file is stored as 39 39 33 32 
(9832). 


Reserved. 


Keyboard table information. 


J=-5 Rev @ - 6/14/83 


Supplemental Technical Reference Material 


J.4 Banner Skeleton Files 


Files with the extension .BAN are banner skeleton files. The 
banner is information printed on the screen during system boot. 
The banner also prints the Logo (if selected) along with other 
information regarding configuration. The banner is a set of ASCII 
strings containing the escape sequences and characters necessary 
to print the logo and configuration information on the console. 


The first 128 bytes of the Banner Skeleton has the following 
format. The first byte is zero followed by @Dh, @Ah. This is 
followed by the length of the file in ASCII decimal with a 
leading and trailing space, and followed by @Dh, Q@Ah. 


The location of the keyboard name and character set name follow 
in the same format as the file name length. If the file length is 
639 characters, the keyboard name is at byte 5@2, and the 
character set name is at 541, then the first 24 bytes of the 
banner file would be as follows: 


38 OD BA 28 36 33 39 28 OGD BGA 28 35 38 32 20 BD BA 2B 
35 34 31 20 OD OA 
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APPENDIX K 
K.1 Victor 99990 Disk Structure 
K.1.1 Victor 9999 Floppy Disk Structure 


The Victor 9998 disk system requires that each track has a 
variable number of sectors, with each sector containing 512 
bytes, with 4 sectors per Allocation Unit (AU), the track 
structure is as follows: 


Track Format 


Track Numbers 


zone Lower Head Upper Sectors Rotational 
Number (*) Head Per Track Period (MS) 

Gg G-3 (unused) 19 237.9 

1 4-15 G-7 18 224.5 

2 16-26 8-18 17 21252 

3 27-37 19-29 16 199.9 

4 38-48 39-49 15 187.6 

5 49-59 41-51 14 175.3 

6 60-79 52-62 13 163.90 

7 71-79 63-74 12 149.6 

8 (unused) 75-79 11 144.9 

Notes: 


(*) The upper head is not present on the single-sided floppy 
machine; only the double-sided floppy machine has the upper and 
lower heads as specified in the table. 


MS-DOS allocates space on a Single Sided diskette (SS) and a 
Double Sided (DS) diskette as follows: 

Track @ Sector @ Disk Label 

Two copies of the File Allocation 
Table (FAT), one FAT in each sector. 
(SS). 

Two copies of the FAT, two sectors 
per FAT. (DS). 


Track @ Sectors 1-2 
Track @ Sectors 1-4 


Track Sectors 3-194 


G Directory (SS) 
Track @ Sectors 5-12 

* 

g 


Directory (DS) 


Data Region (SS) 
Data Region (DS) 


Sectors ll- 
Sectors 13- 


Track 
Track 


Files, under MS-DOS, are not necessarily written sequentially on 


the diskette. Diskette space for a file in the data region is 
allocated on a sector by sector basis, skipping any currently 
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allocated sectors. The first unused sector found in the data 
region will be the next sector used, regardless of where it 
appears on the diskette, This method allows for the most 
efficient use of the disk space available, as sectors made 
available once a file has been erased can be re-allocated to new 
files. 


K.1.2 Victor 9990 Hard Disk Structure 


The hard disk system, in the Victor 9900, is split into virtual 
volumes - thus what is in reality one physical disk may be broken 
into several virtual disks. This means that one large disk system 
is broken up into several smaller, and therefore, more managable 
smaller ‘disks'. 


The virtual volumes are described by a volume list placed in the 
drive label by the hard-disk configuration utility. This list 
could be of any length, but in practice will contain only a few 
entries. Partitioned into smaller ‘disks', where each hard disk 
partition will appear as contiguous storage to the user; this is 
achieved by dividing the physical address space into Regions and 
translating logical addresses into these areas. Regions typically 
represent uSable areas between unusable spots in the media. The 
initial Region list is created after the unit is formatted and 
_configured, and it is ordered by physical address. If areas of 
the disk should become 'bad' during use, the list can be re- 
ordered to effectively replace the bad track with a spare track 
located elsewhere on the disk. be 
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K.1.2.l Victor 999@ Hard-Disk Label Format 


The hard-disk has a label that is used both at boot and run time, 
this label informs the system of the size and structure of the 
hard-disk media. Located in sector 9, the label is as follows: 


Field Name Data Type Contents BOOT BIOS HDSETUP TEST 
Label Type WORD 999 = unqualified R R R/W O 
9601 = Current Rev. 

Device ID WORD 9001 = Current Rev. R R R W 
Serial Number BYTE(16) ASCII - - R W 
Sector Size WORD 512 R R R Ww 
IPL Vector 

Disk Address DWORD Logical Address R - W O 
Load Address WORD Paragraph Number 

Load Length WORD Paragraph Count 

Cod_Entry PTR Memory Address 

Primary Boot Volume 

WORD Virtual Volume # - R W 6) 

Control Parms BYTE(16) (for Tandon TM6@3SE) R R - W 


# Cylinders BYTE(Hi) @@Hex 
BYTE(Lo) E6Hex (=23@) 
# Heads BYTE G6Hex (=6) 
lst reduced- BYTE(Hi) @@Hex 
current cyl. BYTE(Lo) 8@Hex (=128) 


lst write- BYTE (Hi) @@Hex 
precomp cyl. BYTE(Lo) 8@Hex (=128) 
ECC data burstBYTE @BHex (=11) 
Options BYTE @2Hex (=2) 
Interleave BYTE @5Hex (=5, note that @ means 5) 
Spares BYTE (6) O0@Hex 
Available Media List - - R W 
Region Count BYTE Number of Regions 
Region Descr (var) (Variable by Region Count) 
Region PA DWORD Physical Address 
Region Size DWORD Block Count 
Working Media List R R R/W 0 
Region Count BYTE Number of Regions 
Region Descr (var) (Variable by Region Count) 
Region PA DWORD Physical Address 
Region Size DWORD Block Count 
Virtual Volume List - R R/W O 
Volume Count BYTE Number of Virtual Vols. 


Volume Address DWORD Virtual Volume label Logical Address 
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The above table describes those elements found in the hard-disk 
label, following is a discussion of the meanings of the entries 
themselves: 


fe) Label Type - this defines the state of the drive layout 
and the revision level of the label. 


fe) Device ID - Classification identifying the arrangement, 
For example, the drive manufacturer, controller 
revision number. This allows for the identification of 
compatible controllers/drives. 


fe) Serial Number - the serial number of the unit is 
stored here. 


fe) Sector size - the physical atomical unit of storage on 
the media. 


fe) Initial Program Load Vector (IPL) - this is a 
descriptor identifying the boot program and its 
location on disk. This information is generated from 
the primary boot volume label via the utility HDSETUP. 


O Disk Address - the logical disk address of the 
boot program image. 

fe) Load Address - the paragraph address of the memory 
where the boot program is to load. A zero entry 
indicates a default load to the highest RAM cy 
location. 

fe) Load Length - the length of the boot program in 
paragraphs. 

te) Code Entry - a long memory address of the starting 


entry of the boot program. Segment of zero 
defaults to the segment of the loaded program. 


fe) Primary Boot Volume - the logical address of the 
virtual volume label containing the IPL vector and 
configuration information. 


O Controller Parameters - a list of controller dependent 
information, for use in device reset and configuration. 


ro) Available Media List - a list of permanent usable areas 
of the disk. This is derived from the available media 
list and from the format funciton of the HDSETUP 


utility. 

fe) Physical Address - disk address of the region. 

fe) Region Size - the number of physical blocks in the 
region. 
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Working Media List - a list of the working areas of the 
disk. This is derived from the Available Media List and 
from the format function of the HDSETUP utility. 


O Physical Address - disk address of the region. 
O Region Size - the number of physical blocks in the 
region. 


Virtual Volume List - a list of the logical disk 
addresses of all virtual volume labels. 
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K.1.2.2 Victor 99900 Hard-Disk Virtual Volume Label Format 


The Virtual Volume Label provides information on the structure of 
the Virtual Volume. Generally the operating system references 
this label, while the HDSETUP utility will create and reference 
it. The Virtual Volume Label appears as follows: | 


Field Name Data Type Contents BOOT BIOS HDSETUP TEST 
Label Type WORD @908 = null . | - R R/W - 
Volume Name BYTE(16) ASCII - - R/W - 
IPL Vector R - W O 
Disk Address DWORD Virtual Address 

Load Address WORD Paragraph Number 

Load Length WORD Paragraph Count 

Code _ Entry PTR Memory Address 
Volume Capacity DWORD # of Physical Blocks - R R/W - 
Data Start DWORD Virtual Address - R R/W = 
Host Block Size WORD MS-DOS = 512 bytes - R R/W - 
Allocation Unit WORD # Of Physical Blocks - R R/W - 
Number of Directory Entries 

WORD Entry Count - R R/W - 
Reserved BYTE(16) Future Expansion - - W = 
Set to Nulls 

Configuration Information = R R/W _ 
Assignment Count BYTE # of assignment mappings 

Assignment (var) (Variable by Assignment Count) 

Device Unit WORD Physical Unit Number 

Volume Index WORD Index into Virtual Volume List 
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The above table describes those elements found in the hard-disk 
Virtual Volume label, following is a discussion of the meanings 
of the entries themselves: 


fo) Label Type - this defines the type of operating 
environment that the virtual volume is configured for. 
It is used for type checking when assigning volumes to 
drives. : 


ve) Volume Name - the name of the virtual volume as defined 
by the user. It is used for identifying volumes. 


fe) Initial Program Load Vector (IPL) - this is a 
descriptor identifying the boot program and its 
location within the virtual volume. This field is used 
to generate the IPL vector on the drive label when 
configuring the primary boot volume. 


re) Disk Address - the virtual disk address of the 
boot program image. 
fe) Load Address - the paragraph address of the memory 


where the boot program is to load. A zero entry 
indicates a default load to the highest RAM 
location. 


fe) Load Length - the length of the boot program in 
paragraphs. 
fe) Code Entry - a long memory address of the starting 


entry of the boot program. Segment of zero 
defaults to the segment of the loaded program. 


fe) Volume Capacity - the number of actual blocks that 
comprise the virtual volume. 


O Data Start - the offset (in blocks) into the virtual 
volume for the start of data space. 


re) Host Block Size - the atomical unit used by the host in 
data trasnsfer operations. 


fe) Allocation Unit (AU) - this operating system dependent 
field means the storage allocation size used by the 
host in the virtual volume. It is used in determining 
disk parameter tables and disk definitions. 


fe) Number of Directory Entries - this operating system 
dependent field means the number of entries in the 
hosts directory. It is used in determining disk 
parameters tables and disk definitions. 


ro) Configuration Information - a list of the drive 
assignments for a system at boot time. It is used to 
map logical drives to virtual volumes. This field is 
referenced via the label of the booted drive. 
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K.2 MS-DOS Disk Directory Structure 


The FORMAT/HDSETUP utilities structure the directory for 128 
entries on a floppy diskette, and a user defined number on the 
hard-disk. The directory entries are structured as follows: 


0-7 Filename (@E5Hex in byte @ indicates 
that this directory entry is unused). 

8-10 Filename extension. 

11 File attribute. In MS-DOS 1.25, the 


contents of this byte may be @2Hex 
indicating a hidden file and @4Hex 
indicating a system file. A directory 
search will not show files with the 
above attributes, unless the extended 
FCB is used. Files without attributes 
will contain @@Hex in this byte. A file 
may be made hidden/system only when 


created. 

12-23 Reserved. 

24-25 Date when file was created or last 
updated. The mm/dd/yy are mapped as 
follows: 
< 25 > < 24 > 
15 14 131211410987°=64«5 4321 ‘@ 
yyyyyepyoymmmmddaddd 


where: 


yy is a value from 9-199 (1980-2999) 
mm is a value from 1-12 
dd is a value from 1-31 


26-27 Starting AU; the relative AU number of 

the first block in the file. For file 
allocation purposes only, relative AU's 
start at OGG. 


Note that relative AU's 9080 and @9@1 are 
the last two AU's of the directory. 
Therefore the data region starts at 
relative AU 9802. The relative AU number 
is stored in normal Intel fashion, Least 
Significant byte first. 


28-31 File size in bytes. The first word 
contains the low-order part of the size. 
Both words are stored Least Significant 
byte first. 
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K.3 MS-DOS File Allocation Tables 


The file allocation table (FAT) is used by DOS to allocate disk 
space for a file, one sector at a time. The FAT is composed of a 
12 bit entry for each Allocation Unit (AU), starting with Track @ 
Sector ll ona single sided disk; Track 8 Sector 13 on a double 
Sided disk, and going through to Track 79 Sector 12 ona single 
sided disk; Track 158 Sector 11 on a double sided disk. 


The third FAT entry (relative AU @@2) begins the mapping of the 
data region; each entry contains three hex digits: 


Od If the AU is unused, and available. 
FFF The last AU in the file. 
nnn Any other hex digits that are the 


relative AU number of the NEXT AU in the 
file. The relative AU number of the 
first AU in the file is kept in the 
files directory entry. 


A copy of the FAT for the last used disk in each drive is kept in 
RAM, and iS written back to the disk whenever the status of the 
disk space used changes. 
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APPENDIX L 


\ew/ Lel Generation of Frequencies with the CODEC 


This appendix covers the use of the CODEC chip within the Victor 
9988 to generate sound. It is beyond the scope of this text to 
cover actual human-voice generation, Victor does provide tools to 
achieve this, but generating a frequency will be discussed. 


The CODEC chip generates sounds by producing a wave form; 
frequency generation is achieved by causing a sine wave to be 
Produced by the CODEC, then varying the time base of the sine 
wave to create various frequencies. Two steps are involved with 
frequency generation; first the initialization step. The 


intialization of the CODEC is to produce the sine wave with no 
time base, the is achieved by the following code: 


codec seg equ Ge89Gh j;codec chip segment 
codec_tab dw G5EGOH, OOD40H, OOFS8GH, BOGCOH 
codec Ingth ~~ equ 4 74 words in the codec table 
ssda | equ G9OG6GH ;SSDA chip port offset 
clkctr equ O@9G8BH ;Codec cloek port 
cdclk equ OG084H ;Codec frequency clock 
init codec: 
~  - push ES 
mov bx,codec_seg ;codec chip segment address 
mov ES ,bx ;ready the segment origin 
mov bx,ssda ;point to the serial chip 
mov si,offset codec tab ,get the init code 
mov cx,codec_lIngth ;get the table length value 
cld 
; 
load_loop: 
lodsw 
mov ES: [bx] ,ax ,save the table value 
loop load_loop ; and loop til Cx = g 
mov bx ,clkctr 
mov ES:byte ptr [bx],@COH ;enable the CODEC Clock 
pop ES 
ret 


Once intialized, the CODEC is ready to respond to frequency 
generation requests. This is simple to achieve by supplying the 
following subroutine with the correct parameters as follows: 
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Routine: PLAY NOTE 

Function: To play a single voice note via the CODEC a 

Entries: CX = Frequency in Hz to be played - 
DX = Duration of note in multiples of 2.5mS : 


AL=@=play note, AL=FF=halt note 


play _note: : 
Or CX ,CX sis freq @ i 
jz dono_end ;yes, exit - 
Or dx ,dx 71s duration @ 
jz dono_end ;yes, exit 

donolg: 
push si 
push bx 
push ES 
mov bx,codec seg ;codec chip segment address 
mov ES ,bx ;ready the segment origin 
cmp al,@ffH 7if AL = FF then stop note 
jne dono5@ 
mov word ptr ES:cdclk,@ ;stop note 
jmp short dono ret 

dono5@: | 
push dx ;save the duration 

Now the input to the SSDA must be calculated - note that the 


lack of 


me me TO MO NH Me We Be 


N= 


This equation may be broken down to: 


following calculation achieves a fairly linear tone generation 
- any deviance from linearity should be fairly minor due to 


precision in the divide. The calculation itself is: 
((5060 O00/F)/8)-l1 ;where F=desired frequency in Hz 
;N 1S the value for the CODEC clock 


N= (62500/F) -1 
mov ax ,62500d ;ready LSW of 625808 decimal 
XOLr ax ,dx smake MSW zeroes 
div cx ;get CODEC input value 
sub ax,l ;normalise to desired value 
pop dx ;get back duration of note 
mov bx ,cdclk 
mov ES: [bx] ,ax ;give the frequency to clock 
time_loop: 
mov ax ,25d ;ready 1 2.5 millisecond period 
micro loop: 
mov cl1,78h ;ready the timing value 
shr cl, el 
dec ax ;188 microseconds has passed - more? 
jnz micro loop 7no, So loop til done 
dec dx | ;see if the note is finished with 
jnz time_loop ; not finished - round again 
time done: ; note playing is over - flush speaker 
mov ES:word ptr [bx],9@ ;Clear the speaker to silence 
dono ret: 
pop ES : 
pop bx - 
pop si sstack clear : 
dono_ end: | * 
ret ; and exit aa 7 
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